home *** CD-ROM | disk | FTP | other *** search
/ PC Media 3 / PC MEDIA CD03.iso / share / os2 / psrt_14 / rsxinst.doc < prev    next >
Encoding:
Text File  |  1994-02-16  |  7.2 KB  |  247 lines
  1. --------------------------------------------------------------------------------
  2. INSTALL.TXT        DPMI-RSX  (c) Rainer Schnitker            Feb 1994
  3. --------------------------------------------------------------------------------
  4.  
  5. This file contains information about:
  6.  
  7.     * Hardware Requirements
  8.     * Software Requirements
  9.     * Create more DPMI memory
  10.     * INSTALL for EMX/GCC
  11.     * INSTALL for DJGPP
  12.     * Major bugs in tested DPMI-Hosts
  13.     * Patch for next EMX-Update
  14.     * Error messages from RSX
  15.  
  16.  
  17.  
  18.  
  19.     This program is distributed in the hope that it will be useful,
  20.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  21.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  22.     GNU General Public License for more details.
  23.  
  24.  
  25.  
  26. --------------------------------------------------------------------------------
  27.  
  28.  
  29.  
  30. Hardware Requirements:
  31. ----------------------
  32.  
  33. - RSX requires a 386SX-CPU (or higher)
  34.  
  35.   (A 387 coprocessor is not necessary, because RSX emulates it)
  36.  
  37.  
  38.  
  39.  
  40. Software Requirements:
  41. ----------------------
  42.  
  43. - A DPMI 0.9/1.0 - Server like:
  44.  
  45.     MS-Windows 3.1 enhanced mode
  46.  
  47.     QEMM386 + QDPMI 1.01
  48.  
  49.     386MAX 6.x, 7.x
  50.  
  51.     OS/2 2.x
  52.  
  53.   To use the 387-emulator the DPMI-server must provide DPMI 1.0 floating-point
  54.   extensions (most 0.9 server support this).
  55.  
  56. - DOS 3.3+ or DOS box emulation
  57.  
  58. - A GNU-C port for DOS like EMX/GCC 0.8e-h or DJGPP 1.06-1.11
  59.  
  60.   or any EMX program that should run under DPMI (like TeX386).
  61.  
  62.  
  63.  
  64.  
  65. Create more DPMI memory: (needed for older DJGPP)
  66. ------------------------
  67.  
  68. MS-Windows 3.1:
  69.     You can set the value PageOverCommit in the system.ini [386Enh] section
  70.     PageOverCommit=8     (default=4)
  71.  
  72.     Specifies the multiplier for determining the amount of linear address space.
  73.     The amount of linear address space is computed by rounding up the amount of
  74.     available physical memory to the nearest 4 megabytes and then by multiplying
  75.     that value to the value specified for this setting.
  76.  
  77.     After that, increase the permanent Swapfile (Control Panel / 386).
  78.  
  79.     Also you can create a smaller DOS-Box. PIF-settings:
  80.     - 400 KB DOS memory maximum [200 KB without rsx387]
  81.       (if you only want to run small DOS programs in RSX)
  82.     - EMS=0 ; XMS=0 ; no High-Memory-Area
  83.  
  84.  
  85. 386MAX 7.0:
  86.     To increase memory you must have a SWAPFILE line in your 386MAX.PRO file
  87.     SWAPFILE=C:\386MAX\386MAX.swp /S=10240
  88.     This creates a 10MB swapfile. The size of the virtual swapfile is the
  89.     amount of virtual memory available to your applications.
  90.  
  91. QEMM + QDPMI:
  92.     Set the environment QDPMI to something like
  93.     QDPMI=SWAPFILE c:\tmp\qdpmi.swp 8192
  94.     This creates a 8 MB swapfile. The sum of the value of availble memory and
  95.     the size of the virtual swapfile is the amount of virtual memory available
  96.     to your applications.
  97.  
  98. OS/2:
  99.     DPMI_DOS_API must have the value AUTO or ON
  100.     DPMI_MEMORY_LIMIT default value is 64 MB, you don't need to change it
  101.     EMS,XMS is not needed.
  102.  
  103.  
  104.  
  105.  
  106. INSTALL for EMX/GCC:
  107. --------------------
  108.  
  109. 1)  Set the environment RSX387, if a 387-emulation is required
  110.     RSX387=C:\RSX\FPU-EMU\RSX387
  111.     You can disable the FPU-EMU with the '-e' command-line switch.
  112.  
  113. 2)  There are two ways to run RSX from bound exe-files:
  114.  
  115.  a) Use emxl.exe from EMX-0.8H.
  116.     If the emxl.exe detects only DPMI it runs RSX.EXE, otherwise EMX.EXE.
  117.     emxl.exe must found RSX.EXE in the current directory or in the PATH.
  118.     Also you can use the Environment RSX=<path>\RSX.EXE (like EMX).
  119.     See also \emx\doc\EMXRT.DOC in EMXRT.ZIP.
  120.  
  121.  b) Set the environment variable EMX to RSX.EXE like
  122.     EMX = C:\RSX\BIN\RSX.EXE .
  123.     Now, bound EXE-files run the RSX-extender instead of EMX. A special PATH
  124.     statement is not necessary.
  125.  
  126.     If you have no coprocessor and you want run the gcc compiler this method
  127.     is recommend. Also you can use the stub emxldpmi.exe. This stub runs
  128.     always RSX, if there is a DPMI-server.
  129.  
  130.  
  131. Notes:
  132.     (a) Note that the default stack is 60 KB. If you need more space, use
  133.     the -s option to grow the stack, or set a environment-var RSXOPT.
  134.     Example: RSXOPT=-s256 sets the stack to 256 Kbytes.
  135.     (see rsxcmds.txt).
  136.  
  137.  
  138.  
  139. INSTALL for DJGPP:
  140. ------------------
  141.  
  142. 1)  Set environment RSX387, if 387-emulation is required.
  143.     RSX387=C:\RSX\FPU-EMU\RSX387
  144.  
  145. 2)  Bound executable must find RSX.EXE in the PATH or current directory.
  146.     Copy the binary files from \rsx\bin to your \djgpp\bin directory.
  147.     Or change the PATH to \rsx\bin.
  148.  
  149. 3)  Creating bound executable:
  150.     a) For go32 version 1.11 you can use the tools coff2exe, stubedit.
  151.     To create a gcc compiler for RSX.EXE do this:
  152.     C:\GCC\BIN> xcopy gcc.exe gccdpmi.exe
  153.     C:\GCC\BIN> stubedit gccdpmi.exe extender=rsx
  154.  
  155.     b) for older versions:
  156.     You must use the new stub STUBDJ.EXE to create bound executable. The
  157.     program BINDDJ puts a stub and the a.out program together:
  158.  
  159.     > BINDDJ stubdj.exe myfile myfile.exe
  160.  
  161.     Stubdj executes RSX if a DPMI-server is there, and go32.exe if there is no
  162.     DPMI-server. To change the gcc compiler exe-stub, use EXE2AOUT from djgpp
  163.     to get the a.out file and use the BINDDJ command to create the new stub.
  164.  
  165.     Example:
  166.     C:\GCC\BIN> exe2aout gcc.exe
  167.     C:\GCC\BIN> binddj stubdj.exe gcc gccd.exe (copy stubdj+gcc gccd.exe)
  168.  
  169.  
  170. [4] Building library LIBRSX.A
  171.     If you want to use signals(), ptrace(), wait(), etc you must build
  172.     the library 'librsx.a'.
  173.     Read the file 'readme' in the \rsx\source\djlibrsx to install
  174.     this futures.
  175.  
  176.  
  177.  
  178.  
  179. Major BUGS in tested Hosts :
  180. ----------------------------
  181.  
  182.     running MS-Windows 3.1
  183.     (exception 3 is not used, int3 handler must installed)
  184.  
  185.     running QEMM + QDPMI 1.01
  186.     - page faults terminate program
  187.     - QDPMI virtuel memory error after memory resize fails (page fault)
  188.       (can happen in GDB.EXE)
  189.  
  190.     running 386MAX 6.00 (the new version 7.00 is ok)
  191.     - control-c handler will never called
  192.  
  193.  
  194.  
  195.  
  196.  
  197. Patch for next EMX-Update:
  198. --------------------------
  199.  
  200. If you upgrade a new EMX version (maybe emx0.8i ?), you always get a warning
  201. message, if you run the rsx.exe file.
  202.  
  203. Now you can patch the RSX.EXE file:
  204.  
  205.     Take a good Hexdump-editor
  206.     Load RSX.EXE
  207.     Search for reversed version number "h8.0"
  208.     Change this value
  209.     Save RSX.EXE
  210.  
  211.  
  212.  
  213. Error messages from RSX:
  214. ------------------------
  215.  
  216. "No DPMI-host found!"
  217.     There is no DPMI-server. Use EMX instead.
  218.  
  219. "32bit programs not supported"
  220.     The DPMI-server supports only 16-bit programs. You can't use RSX.
  221.  
  222. "Can't alloc memory for the DPMI-host-stack"
  223.     The DPMI-server needs some DOS memory for RSX.
  224.     Do you have enough DOS memory?
  225.  
  226. "can't switch to Protected Mode"
  227.     DPMI-server can't switch RSX in Protected Mode.
  228.     Do you have enough extended memory?
  229.  
  230. "No DPMI-server 387 support", "use -e option"
  231.     DPMI-server doesn't support a coprocessor. Use 'RSX -e prog' or set
  232.     the environment 'RSXOPT=-e'.
  233.  
  234. "error:can't get int21", "error:can't set int21"
  235.     RSX can't change the interrupt vector 0x21.
  236.  
  237. "error: not a valid PSP option -/xxxx/\n"
  238.     EMXBIND error in bound executable.
  239.  
  240. "Can't find RSX387"
  241.     Set the environment RSX387 like RSX387=c:\rsx\fpu-emu\rsx387
  242.  
  243. "Can't load emu: "
  244.     Not enough memory for 387 emulator. Try -p option or increase DOS
  245.     memory.
  246.  
  247.